home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / apidev / tpapi.doc < prev    next >
Text File  |  1994-01-14  |  10KB  |  265 lines
  1.               *************************************************
  2.               * Turbo Pascal API's for Novell Netware (TPAPI) *
  3.               *************************************************
  4.  
  5.     TPAPI (c) Copyr. 1991, 1992, 1993 Antonio Covelli ALL RIGHTS RESERVED
  6.  
  7.  
  8. VERSION CHANGES (reverse chronological order)
  9. ===============
  10.  
  11. Version 1.51 - Released 1st September, 1993
  12.  
  13. * Changed bug in GetVolumeName (NWDIR) so that the volumename is correctly
  14.   returned. Also changed to the NCP protocol.
  15.  
  16. * Implemented ConvertPathToDirectoryEntry in NETWARE.
  17.  
  18. * Implemented MapDirectoryNumberToPath in NETWARE.
  19.  
  20. * Moved duplicate functions ScanBinderyObjectTrusteePaths from NWBINDRY &
  21.   NWDIR to NETWARE.  Also changed it to use the NCP protocol.
  22.  
  23. * Changed GetServerInformation (NWFSSERV) to use the NCP protocol.
  24.  
  25. * Added ScanFileDirectoryExtTrustee API to NWDIR.  This also uses the NCP
  26.   protocol.
  27.  
  28. * Changed Rights parameter in GetEffectiveRights to be TrusteeRights.
  29.  
  30. * Added AddExtTrusteeFileDirectoryTrustee API to NWDIR.  This also use the NCP
  31.   protocol.
  32.  
  33. * Added Netware v3.11 support for GetConnectionsOpenFiles in NWDIR.
  34.  
  35. * Started optimizing certains portions of code within NETWARE.  Many thanks
  36.   go to Peter Sawatzki for prompting me to look into this.
  37.  
  38. * Removed FileServiceRequest from NETWARE.  This is exactly the same as
  39.   NCPRequest except that the buffer lengths are passed before their
  40.   respective buffers.
  41.  
  42. * Fixed bug in _IPXInitialise that would stop it from working with the
  43.   older shells.
  44.  
  45. * Fixed bug in GetVolumeInfoWithNumber (NWDIR) in that it would not work in
  46.   DPMI mode.
  47.  
  48. * Fixed bug in MapFakeRoot (NWWRKSTN) in that it would not work in DPMI mode.
  49.  
  50. * Removed ServerRequest from NETWARE and renamed ServerReq to ServerRequest.
  51.  
  52. * Added support for KeyedChangePassword, KeyedVerifyPassword.  See example
  53.   KEYPASS for additional info.
  54.  
  55. * Changed all BinderyOBJ methods to use the NCP protocol. This will allow
  56.   proper interfacing to the VLM once I activate the 2F facility.
  57.  
  58. * Started changing all the API's to use the NCP protocol.  This methods
  59.   uses Request, Receive buffers for most (if not all) of the calls.
  60. --------------------------------------------------------------------------------
  61.  
  62. Version 1.50 - Released : 1st July, 1993
  63.  
  64. * Encrypted password support is now available thanks to Barry Nance.  Barry
  65.   has kindly allowed me to incorporate his ELOGON source code into TPAPI.
  66.   The source (in NWENCRYP) was from Software Corner, Byte Magazine.
  67.  
  68. * Changed all declared TYPES in NWVAR.  The following example show the change
  69.  
  70.       ObjectNameType    ->     TObjectName
  71.       PathNameType      ->     TPathName
  72.  
  73.   This way of declaring TYPES seems to be more or less a standard in the
  74.   industry.
  75.  
  76. * TPAPI is now DPMI/REAL mode compatible!  I have done some preliminary
  77.   testing under Windows and have found no problems so far.
  78.  
  79. * Changed the following object names :
  80.  
  81.       ConnectOBJ        ->     ConnectionOBJ
  82.       FServOBJ          ->     FileServiceOBJ
  83.       SynchOBJ          ->     SynchronisationOBJ
  84.       WorkStatOBJ       ->     WorkStationOBJ
  85.  
  86. * Added lots of examples to do some of the more difficult things in Netware.
  87.   E.G.  Printing to LPT ports, printing directly to queues, using semaphores
  88.   and getting workstation information.
  89.  
  90. --------------------------------------------------------------------------------
  91.  
  92. Version 1.44 - Not released : Internal version
  93.  
  94. * Changed ConvertNodeAddress, ConvertNetworkNumber to be functions.
  95.  
  96. * Added dynamic allocation of the request/receive buffers.  When initialising
  97.   objects if you pass true then the buffers are allocated and deallocated for
  98.   each method, if you pass in false then they are allocated once and
  99.   deallocated when you call the object's done method.
  100.  
  101.   The second method is faster but the memory is always taken up whereas in
  102.   the first option you only use the memory when calling a TPAPI api.
  103.  
  104. --------------------------------------------------------------------------------
  105.  
  106. Version 1.43 - Not released : Internal version
  107.  
  108. * Changed ExamineSemaphore (SemaphoreValue), OpenSemaphore (IntialValue) to
  109.   be of type INTEGER.  Semaphore values can be negative as well as positive.
  110.  
  111. * Instead of using PObjectListing I have now changed all methods to use
  112.   PStringCollections for efficency.  The collections are all SORTED as they
  113.   are generated.
  114.  
  115.   Basically you need to include the OBJECTS unit in your USES clause.  To
  116.   see more information check out the BINDLIS1.PAS file.
  117.  
  118.   Please consult your Turbo Vision manual for more technical information on
  119.   collections.
  120.  
  121. * Removed data type Set_Capture_Flags from NWVAR as it is not used anywhere.
  122.  
  123. * Added capability to handle fake roots.  Requires NETX.* v3.0 or later.
  124.   MAPFAKEROOT, DELETEFAKEROOT and GETRELATIVEDRIVEDEPTH can be found in
  125.   NWWRKSTN.
  126.  
  127. * Added fake root capability to MISCMAPDRIVE in NWMISC.
  128.  
  129. --------------------------------------------------------------------------------
  130.  
  131. Version 1.42 - Released : Internal version
  132.  
  133. * Changed constant BF_SET in NWVAR to be $02.
  134.  
  135. * Fixed problem in SCANPROPERTY in NWBINDRY so that the next sequence number
  136.   returned is correct.
  137.  
  138. * Moved constant HexCharacterSet into HexString function. (NETWARE)
  139.  
  140. * Started on the long road to DPMI compliance with a lot of help from
  141.   Mark Edington (Borland USA).
  142.  
  143. * Within NWQUEUE changed all references to FileOfByte to FileOfText.
  144.  
  145. * Fixed bug within GetQueueJobList (NWQUEUE) which was that the number of jobs
  146.   within a queue were not all correctly returned.
  147.  
  148. * Added function GetTPAPIVersion (NETWARE) which returns a string containing
  149.   the version and release date of TPAPI.
  150.  
  151. --------------------------------------------------------------------------------
  152.  
  153. Version 1.41 - Released : 19th February, 1993
  154.  
  155. * Recompiled under Turbo Pascal 7.0 (REAL mode only).
  156.  
  157. --------------------------------------------------------------------------------
  158.  
  159. Version 1.4 - Released : 10th October, 1992
  160.  
  161. * Changed GetObjectName to GetObjectNameID (NWMISC.TPU) so that the objectid
  162.   is now also returned.
  163.  
  164. * Changed the inner workings of certain parts of the Misc Servvices unit
  165.   (NWMISC.TPU). This should be transparent to everyone.  The MiscFuncOBJ now
  166.   uses less memory.
  167.  
  168. * Removed the parameter ConnectionID from LoginToFileServer in Connection
  169.   unit (NWCONN.TPU) as it is not used.
  170.  
  171. * Changed GetFileServerMiscInformation (NWFSSERV.TPU) to return the fourth
  172.   dynamic memory pool in Netware 286 v2.2
  173.  
  174. * Fixed bug in GetNetworkSerialNumber (NWSERIAL.TPU) so that it properly
  175.   returns the requested information.
  176.  
  177. * Changed ConnectionID in SetCapturePrintQueue (NWPRINT.TPU) to be a WORD
  178.   instead of a BYTE.
  179.  
  180. * Changed GetNetwareShellVersion (NWWRKSTN.TPU) to return the shell type.
  181.  
  182. * Added GetTaskMode & SetTaskMode to WorkStation Services (NWWRKSTN.TPU)
  183.  
  184. * Fixed bugs in SetDefaultCaptureFlags/SetSpecificCaptureFlags (NWPRINT.TPU)
  185.   which caused incorrect setting of the Timeout count.
  186.  
  187. * Changed DriveHandle to DirectoryHandle in SpecifyCaptureFile (NWPRINT.TPU).
  188.  
  189. * Added SetShowDots (NWWRKSTN.TPU) to allow the switching of whether or not
  190.   '.' and '..' are seen in directory listings (useful for Windows).
  191.  
  192. * Changed SetDefaultCaptureFlags, SetSpecificCaptureFlags (NWPRINT.TPU) to use
  193.   Capture_Flags structure instead of Set_Capture_Flags.
  194.  
  195. * Modified the PrinterSetupBuffer, PrinterResetBuffer in Print Services.
  196.   (NWPRINT.TPU).
  197.  
  198. * Added SetNWCaptureFlags to Misc Services (NWMISC.TPU).  This procedure sets
  199.   the default for the structure Capture_Flags.
  200.  
  201. * Added GetPrintQueueDirectoryID to Misc Services (NWMISC.TPU).
  202.  
  203. * Fixed bug in GetFileServerLoginStatus (NWFSSERV.TPU) so that it returns
  204.   correct information.
  205.  
  206. --------------------------------------------------------------------------------
  207.  
  208. Version 1.3 - Released : 2nd March, 1992
  209.  
  210. * Added MakeSupervisor, RevokeSupervisor to Misc Services unit (NWMISC.TPU)
  211.   Allows programmer to easily make an object security equivalent or not to the
  212.   Supervisor.
  213.  
  214. --------------------------------------------------------------------------------
  215.  
  216. Version 1.2 - Released : Internal version
  217.  
  218. * Finally completed FileServer Services unit (NWFSSERV.TPU).
  219.  
  220. * Added several more examples which show how easy it is to replicate Novell
  221.   utilities.
  222.  
  223. * MapV3TrusteeRightsToV2 (NWDIR.TPU) fixed bug which gave incorrect info.
  224.  
  225. * Changed _NWMapWildPath (NETWARE.TPU) to a function.
  226.  
  227. * Moved all table pointers out of NetwareOBJ.
  228.  
  229. --------------------------------------------------------------------------------
  230.  
  231. Version 1.1 - Released : Internal version
  232.  
  233. * Added a complete new suite of API's - Queue services.  The only difference
  234.   from Netware is that no file handles are returned, instead a FileOfByte
  235.   type is used.
  236.  
  237. * Added more API's throughout.
  238.  
  239. * Added AutoLogin function to NWMISC unit.
  240.  
  241. * Moved FileServerNameTable & ServerConnectionIDTable out of NetwareOBJ.
  242.  
  243. * Changed variable FileSize to SizeOfFile in certain units.
  244.  
  245. * Started the documentation in real anger.
  246.  
  247. * FileServerServices (NWFSSERV.TPU) - Possible bug in Netware
  248.  
  249.     GetExtendedFileAttributes is meant to return the FileAttributes and a
  250.     result.  When you call the function both the FileAttributes and the result
  251.     are the same value.
  252.  
  253. --------------------------------------------------------------------------------
  254.  
  255. Version 1.0b - Released 4th December, 1991
  256.  
  257. * First real release of the library for Turbo Pascal 6.0.
  258. * Certain limitations do exist :
  259.  
  260.     You cannot use any method on a file server that has ENCRYPTED PASSWORDS
  261.     set to on.
  262.  
  263. --------------------------------------------------------------------------------
  264.  
  265. Antonio Covelli